Port DIAGNOSTICS - DOIP-PCAP

Port for diagnostics based on the DoIP protocol using a PCAP device

此端口要求安装 PCAP 驱动。

Stimulation

此端口不具备激励能力。

Name

在以下情况下可用

默认值

有效值

Type

Description

TLS

[ONLINE]

string

[可选] 若要使用 TLS 保护连接,则为 TLS 端口的名称。必须在该工具上创建此 TLS 端口。

网络接口卡

[ONLINE]

string

Used network interface card

MAC 地址 ❲客户端❳

‘02:00:4C:4F:4F:50’

string

字符串(格式:02:00:4C:4F:4F:50);若应使用适配器的 MAC 地址,则为 ‘default’

IP version

IPv4

[IPv4, IPv6]

string

所用 IP 版本的选择

IP 地址 ❲客户端❳

string

用作客户端的 IP 地址。它必须与被测设备的 IP 地址位于同一子网,且不得等于其他参与者的 IP 地址,也不得等于操作系统分配给所选网络接口的 IP 地址。

网关地址

string

IP address, leave empty if no gateway is needed

Subnet mask / prefix length

‘default’

string

对于 IPv4 地址,可以给出子网掩码或前缀长度(格式:‘255.255.255.0’ 或 ‘24’)。‘default’ 使用该 IP 地址(客户端)所属网络类的默认子网掩码。

对于 IPv6,只接受前缀长度,且不支持值 ‘default’。

VLAN ID

0

int

ID with which VLAN packets should be tagged. (0 -> VLAN is not used)

AuthenticationConfiguration

Authentication (0x29) AuthenticationConfiguration:Authentication (0x29) authenticationConfiguration (0x08):表示服务器所提供的认证配置。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - AuthenticationConfigurationResult - 或 NegativeResponse

AuthenticationDeauthenticate

Authentication (0x29) DeAuthenticate:Authentication (0x29) deAuthenticate (0x00):请求退出已认证状态

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - AuthenticationDeauthenticateResult - 或 NegativeResponse

AuthenticationProofOfOwnership

Authentication (0x29) ProofOfOwnership:Authentication (0x29) proofOfOwnership (0x03):校验来自客户端的所有权证明。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

EphemeralPublicKeyClient

ByteStream

客户端为 Diffie-Hellman 密钥协商生成的临时公钥。 ByteStream

ProofOfOwnershipClient

ByteStream

对先前给出的质询的所有权证明,由服务器校验。ByteStream

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - AuthenticationProofOfOwnershipResult - 或 NegativeResponse

AuthenticationVerifyCertificateUnidirectional

Authentication (0x29) VerifyCertificateUnidirectional:Authentication (0x29) verifyCertificateUnidirectional (0x01):通过验证证书来启动认证。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

CertificateClient

ByteStream

要验证的证书。ByteStream

ChallengeClient

ByteStream

challenge(质询)包含整车厂特定格式的客户端数据(可能包含随机化信息),或者是一个随机数。此参数记录用于将该 challenge 传输到服务器。 ByteStream

CommunicationConfiguration

int

有关在 Authentication 之后如何在进一步的诊断通信中处理安全性的配置信息。

注 1 该信息与响应消息数据参数 sessionKeyInfo 是否存在及其内容相关。该参数的格式、会话密钥的生成以及证明值的计算均由整车制造商自行决定。

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - AuthenticationVerifyCertificateUnidirectionalResult - 或 NegativeResponse

CallService

执行诊断服务请求。

示例:要调用 UDS 服务 Read Data by Identifier(SID=0x22,DID=0xACDC),Request 为 ByteStream(“22 AC DC”)

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

Request

ByteStream

要发送的诊断服务请求(ByteStream)

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - :

CallServiceFunctional

以功能寻址方式执行诊断服务请求。

示例:要调用 UDS 服务 Read Data by Identifier(SID=0x22,DID=0xACDC),Request 为 ByteStream(“22 AC DC”)

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

Request

ByteStream

要发送的诊断服务请求。ByteStream

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

object

诊断结果列表(:)。

ClearDTCs

ClearDiagnosticInformation (0x14):清除一个或多个服务器内存中的诊断信息。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

GroupOfDTC

0xFFFFFF

int

要清除的 DTC 或 DTC 组的编号(默认值:0xFFFFFF = 所有 DTC)

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DiagResult - 或 NegativeResponse

CloseSession

关闭诊断会话。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

DiagnosticSessionControl

DiagnosticSessionControl (0x10):在服务器中启用不同的诊断会话。注意,切换诊断会话可能导致 ECU 复位。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

SessionType

int

要发送的诊断会话。1: DefaultSession, 2: ProgrammingSession, 3: ExtendedDiagnosticSession, 4: Safety SystemDiagnosticSession

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DiagnosticSessionControlResult - 或 NegativeResponse

ECUReset

ECUReset (0x11):请求服务器复位。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Subfunction

int

要执行的复位子功能

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - ECUResetResult - 或 NegativeResponse

InputOutputControlByIdentifier

InputOutputControlByIdentifier (0x2F):用某个值替代输入信号、服务器内部函数,和/或强制将电子系统的输出(执行器)控制在某个值上。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

ControlEnableMaskRecord

ByteStream

位掩码,用于指定 shortTermAdjustment 时要调整的参数。ISO 14229-1 规定仅当 DID 由多个参数组成时才使用。

ControlStateRecord

ByteStream

Control 类型 “shortTermAdjustment” 的 DataRecord

DataIdentifier

int

Identifier

InputOutputControlParameter

int

根据 ISO 14229-1 附录 E.1 的控制类型:

0 = returnControlToECU,

1 = resetToDefault,

2 = freezeCurrentState,

3 = shortTermAdjustment

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - InputOutputControlByIdentifierResult - 或 NegativeResponse

OpenDiagSession

Opens a UDS diagnostic session which uses DoIP. If a session with the specified parameters already exists, the handle of the existing session is returned instead of opening a new one.

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

activateRouting

False

[False, True]

bool

Indicates whether the DoIP entity shall forward diagnostic messages to an internal device - Boolean

activationType

ByteStream(“00”)

ByteStream

Routing type in case of routing activation (e..b 0x00 -> default, 0x01 -> WWH-OBD, 0xE0 -> Central Security, further values can be taken from the standard)

diagTimeout

5000

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

doIpVersion

2

int

Version of the DoIP protocol

eid

ByteStream(“”)

ByteStream

ID of the DoIP entity to which a connection is to be established. If specified, a vehicle identification request is sent to this ID to establish the connection. If not, a general vehicle identification request is sent and a connection is established with the first responding control unit.

listenPort

0

int

Port on which to expect responses from the DoIP entity.

remotePort

13400

int

Destination port on which the DoIP entity receives diagnostic requests

retryDelay

int

Delay in ms between retries. With None, the delay is approx. 300 ms.

retryOnBusy

-1

int

Number of retries in case of error (-1 for infinity)

sourceAddress

ByteStream(“”)

ByteStream

The diagnostic address from which diagnostic messages are sent

startRequest

ByteStream

Diagnostic request to open a session

stopRequest

ByteStream

Diagnostic request to end a session

targetAddress

ByteStream(“”)

ByteStream

The diagnostic address of the DoIP entity(ies). If specified, no vehicle identification request is sent and UDS requests are sent directly to this address.

targetIp

string

IP address of the DoIP entity

testerPresentCycleTime

int

Interval for periodic tester-present signaling (in ms)

testerPresentRequest

ByteStream

Diagnostic request for periodic tester-available signaling

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

int

诊断会话的句柄

OpenTcfDiagSession

打开在 TCF 中配置的诊断会话。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SUT

object

诊断会话的句柄。可以是 TCF 中指定的 SUT 名称,或 None。仅当只指定了一个 SUT 时才能使用 None。

ReadDataByIdentifier

ReadDataByIdentifier (0x22):按一个或多个 dataIdentifier 从服务器请求数据记录值。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

DataIdentifier

int

Identifier

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DataRecordDiagResult - 或 NegativeResponse

ReadMemoryByAddress

ReadMemoryByAddress (0x23):允许客户端通过提供的起始地址和要读取的内存大小向服务器请求内存数据。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

MemoryAddress

int

内存地址

MemorySize

int

要读取的数据长度

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - MemoryDiagResult - 或 NegativeResponse

RecoverDiagnosticSessions

Shutsdown and reopens all open diagnostic sessions of the port the job is called on. Each session will keep its currently active settings.

此作业属于 Add-on ecu.test diagnostics。

Parameterization

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

object

包含已恢复的诊断会话句柄的列表

ReportDTCByStatusMask

ReadDTCInformation (0x19) reportDTCByStatusMask (0x02):该参数指定服务器应向客户端发送与客户端定义的状态掩码相匹配的 DTC 列表及相应状态。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

StatusMask

0xFF

int

状态掩码:仅查询至少设置了掩码中所指定状态位之一的 DTC。(默认值:0xFF = 任意状态)

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DTCListDiagResult - 或 NegativeResponse

ReportDTCFaultDetectionCounter

ReadDTCInformation (0x19) reportDTCFaultDetectionCounter (0x14):此参数指定服务器应向客户端发送当前“prefailed”DTC 的列表,这些 DTC 已被或尚未被检测为“pending”或“confirmed”。

DTCFaultDetectionCounter 的用途是提供一种简单方法,用于识别某个特定 DTC 的 statusOfDTC 字节无法识别/读取的渐进性问题或间歇性问题。DTCFaultDetectionCounter 的内部实现应视车辆制造商而定(例如字节数、有符号还是无符号等),但报告的值应为缩放后的 1 字节有符号值,使得 +127 (7F16) 表示测试结果为 “failed”,而任何其他非零正值表示测试结果为 “prefailed”。但 DTCFaultDetectionCounter 值为 +127 的 DTC 不应按下述规则报告。每次测试逻辑运行并指示该次测试运行失败时,DTCFaultDetectionCounter 应按车辆制造商规定的量递增。

报告的 DTCFaultDetectionCounter 值大于零且小于 +127(即 0116 至 7E16)表示已满足 DTC 启用条件,并且未完成的测试结果至少在一个条件或阈值上处于 prefailed 状态。

只应报告 DTCFaultDetectionCounter 为小于 +127 (7F16) 的非零正值的 DTC。

每当测试逻辑运行并指示该次测试通过时,DTCFaultDetectionCounter 应按整车制造商规定的数值递减。如果 DTCFaultDetectionCounter 递减到零或以下,则不应再在肯定响应报文中报告该 DTC。DTCFaultDetectionCounter 的值不应在操作循环之间保持。

若收到 ClearDiagnosticInformation 服务请求,则所有 DTC 的 DTCFaultDetectionCounter 值均应重置为零。其他重置条件应由车辆制造商定义。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DTCFaultCounterDiagResult - 或 NegativeResponse

ReportDTCSnapshotIdentification

ReadDTCInformation (0x19) reportDTCSnapshotIdentification (0x03):此参数规定,服务器应向客户端发送所有 DTCSnapshot 数据记录标识 [DTC 编号与 DTCSnapshot 记录编号]。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DTCSnapshotIdentificationDiagResult - 或 NegativeResponse

ReportDTCSnapshotRecordByDTCNumber

ReadDTCInformation (0x19) reportDTCSnapshotRecordByDTCNumber (0x04):此参数规定服务器应向客户端发送与客户端定义的 DTC 编号和 DTCSnapshot 记录编号相关联的 DTCSnapshot 记录(FF16 表示所有记录)。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

DoExtendedInterpretation

False

[False, True]

bool

如果要以解释后的形式返回快照数据,则为 True,否则为 False。解释通过额外的 ReadDataByIdentifier 调用(0x22)完成。仅适用于固定长度的数据标识符值。默认值:False

DTCMaskRecord

object

DTC 标识符:3 字节值,包含 DTCHighByte、DTCMiddleByte 和 DTCLowByte,三者共同构成要报告的诊断故障码的唯一标识号。例如 0x123456 或 SAE J2012 P-code:“P1234-56”

DTCSnapshotRecordNumber

int

DTC 快照记录编号:要检索其 DTC 快照记录数据的指定 DTC 的特定发生实例。若应报告所有已记录的快照,请指定 0xFF。

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DTCSnapshotRecordDiagResult - 或 NegativeResponse

ReportDTCWithPermanentStatus

ReadDTCInformation (0x19) reportDTCWithPermanentStatus (0x15):此参数规定,服务器应向客户端发送具有“permanent DTC”状态的 DTC 列表。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DTCListDiagResult - 或 NegativeResponse

ReportEmissionsOBDDTCByStatusMask

ReadDTCInformation (0x19) reportEmissionsOBDDTCByStatusMask (0x13):该参数规定,服务器应向客户端发送与排放相关的 OBD DTC 列表以及与客户端定义的状态掩码相匹配的相应状态。所报告的 OBD DTC 列表应仅包含需要符合排放相关法规要求的 DTC。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

StatusMask

0xFF

int

状态掩码:仅查询至少设置了掩码中所指定状态位之一的 DTC。(默认值:0xFF = 任意状态)

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DTCListDiagResult - 或 NegativeResponse

ReportFirstConfirmedDTC

ReadDTCInformation (0x19) reportFirstConfirmedDTC (0x0C):此参数规定服务器应向客户端发送自上次清除诊断信息以来服务器检测到的第一个已确认 DTC。

通过该 SubFunction 参数报告的信息应独立于已确认 DTC 的老化过程(例如,如果某个 DTC 老化到其状态允许被重置,则无论之后又有哪些其他 DTC 变为已确认,服务器都应继续保留第一条已确认的 DTC 记录)。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DTCListDiagResult - 或 NegativeResponse

ReportFirstTestFailedDTC

ReadDTCInformation (0x19) reportFirstTestFailedDTC (0x0B):此参数规定服务器应向客户端发送自上次清除诊断信息以来服务器检测到的第一个失败的 DTC。注意,通过此 SubFunction 参数报告的信息与 DTC 是否已确认或已老化无关。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DTCListDiagResult - 或 NegativeResponse

ReportMirrorMemoryDTCByStatusMask

ReadDTCInformation (0x19) reportMirrorMemoryDTCByStatusMask (0x0F):该参数规定,服务器应向客户端发送从 DTC 镜像存储器中取出的 DTC 列表以及与客户端定义的状态掩码相匹配的相应状态。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

StatusMask

0xFF

int

状态掩码:仅查询至少设置了掩码中所指定状态位之一的 DTC。(默认值:0xFF = 任意状态)

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DTCListDiagResult - 或 NegativeResponse

ReportMostRecentConfirmedDTC

ReadDTCInformation (0x19) reportMostRecentConfirmedDTC (0x0E):此参数指定服务器应向客户端发送自上次清除诊断信息以来检测到的最新已确认 DTC。

请注意,通过此 SubFunction 参数报告的信息应独立于已确认 DTC 的老化过程(例如,如果某个 DTC 老化到其状态允许被复位,则在之后没有其他 DTC 变为已确认的情况下,服务器应继续保留第一条已确认 DTC 记录)。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DTCListDiagResult - 或 NegativeResponse

ReportMostRecentTestFailedDTC

ReadDTCInformation (0x19) reportMostRecentTestFailedDTC (0x0D):此参数规定,服务器应向客户端发送自上次清除诊断信息以来服务器检测到的最新一次失败的 DTC。请注意,通过此 SubFunction 参数报告的信息应与该 DTC 是否已确认或已老化无关。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DTCListDiagResult - 或 NegativeResponse

ReportNumberOfDTCByStatusMask

ReadDTCInformation (0x19) reportNumberOfDTCByStatusMask (0x01):该参数规定,服务器应向客户端传输与客户端定义的状态掩码相匹配的 DTC 数量。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

StatusMask

0xFF

int

状态掩码:仅查询至少设置了掩码中所指定状态位之一的 DTC。(默认值:0xFF = 任意状态)

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DTCNumberDiagResult - 或 NegativeResponse

ReportNumberOfEmissionsOBDDTCByStatusMask

ReadDTCInformation (0x19) reportNumberOfEmissionsOBDDTCByStatusMask (0x12):此参数指定服务器应向客户端发送与客户端定义的状态掩码相匹配的排放相关 OBD DTC 数量。所报告的 OBD DTC 数量应仅为那些需要与排放相关法规要求兼容的 DTC。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

StatusMask

0xFF

int

状态掩码:仅查询至少设置了掩码中所指定状态位之一的 DTC。(默认值:0xFF = 任意状态)

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DTCNumberDiagResult - 或 NegativeResponse

ReportNumberOfMirrorMemoryDTCByStatusMask

ReadDTCInformation (0x19) reportNumberOfMirrorMemoryDTCByStatusMask (0x11):该参数规定,服务器应向客户端发送镜像存储器中与客户端定义的状态掩码相匹配的 DTC 数量。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

StatusMask

0xFF

int

状态掩码:仅查询至少设置了掩码中所指定状态位之一的 DTC。(默认值:0xFF = 任意状态)

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DTCNumberDiagResult - 或 NegativeResponse

ReportSupportedDTCs

ReadDTCInformation (0x19) reportSupportedDTC (0x0A):此参数规定服务器应向客户端发送服务器内支持的所有 DTC 及对应状态的列表。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DTCListDiagResult - 或 NegativeResponse

ReportUserDefMemoryDTCByStatusMask

ReadDTCInformation (0x19) reportUserDefMemoryDTCByStatusMask (0x17):此参数规定,服务器应向客户端发送用户自定义 DTC 存储区中的 DTC 及其状态列表,这些状态需与客户端定义的状态掩码匹配。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

MemorySelection

int

用户定义的 DTC 存储器:只检索存储在所选存储器中的 DTC。

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

StatusMask

0xFF

int

状态掩码:仅查询至少设置了掩码中所指定状态位之一的 DTC。(默认值:0xFF = 任意状态)

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - UserDTCListDiagResult - 或 NegativeResponse

RequestDownload

RequestDownload (0x34):用于发起从客户端到服务器的数据传输(下载)。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

DataFormatIdentifier

00

ByteStream

指定对要发送的数据所用压缩(高半字节)和加密(低半字节)方法。值 0 表示不压缩也不加密。其他所有值均由制造商定义。 ByteStream

MemoryAddress

ByteStream

要写入数据的服务器内存起始地址。ByteStream

MemorySize

ByteStream

TransferData 作业要发送的数据大小。如果对数据使用了压缩,则此参数是指压缩后数据的大小还是未压缩数据的大小取决于制造商。ByteStream

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - RequestDownloadResult - 或 NegativeResponse

RequestTransferExit

RequestTransferExit (0x37):客户端用它结束客户端与服务器之间的数据传输(上传或下载)。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DiagResult - 或 NegativeResponse

RoutineControl

RoutineControl (0x31):客户端使用 RoutineControl 服务执行已定义的步骤序列,并获取相关结果。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

hasRoutineInfo

[False, True]

bool

optional

RoutineId

int

例程的 ID

RoutineOptionRecord

ByteStream

例程参数(可选) ByteStream

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Subfunction

1

int

子功能:Start (0x01)、Stop (0x02)、Request (0x03)

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - RoutineDiagResult - 或 NegativeResponse

SecurityAccessRequestSeed

SecurityAccess (0x27) requestSeed:请求具有车辆制造商所定义安全级别的种子。此外还可以指定一个 Seed&Key 库,用于计算与所获种子对应的密钥。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

Options

object

要传递给 Seed&Key 库的选项字符串(可选 - str)。如果 Options 为 None,则调用库函数 GenerateKeyEx()。如果 Options 是字符串,则调用库函数 GenerateKeyExOpt(),即使是空字符串也是如此。

SecurityAccessDataRecord

ByteStream

请求 seed 信息时额外传输的数据(可选)。ByteStream

SecurityLevel

int

要解锁的安全级别,0x01 与 0x7D 之间的奇数

SeedAndKeyLibraryPath

string

用于计算与所获得种子对应的密钥的 Seed&Key 库路径(可选)

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

Variant

string

要传递给 Seed&Key 库的 ECU 变体限定符(可选)

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - SecurityAccessDiagResult - 或 NegativeResponse

SecurityAccessSendKey

SecurityAccess (0x27) sendKey:发送带有车辆制造商定义的安全等级的密钥。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SecurityKey

ByteStream

用于解锁所需安全级别的密钥。如果 SecurityAccessRequestSeed Job 使用了 Seed&Key 库,则计算出的密钥会在 SecurityAccessRequestSeed Job 的结果中返回。否则必须事先根据 SecurityAccessRequestSeed Job 结果中返回的 seed 计算出密钥。ByteStream

SecurityLevel

int

要解锁的安全级别,0x02 到 0x7E 之间的偶数(= SecurityAccessRequestSeed 的 SecurityLevel + 1)

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DiagResult - 或 NegativeResponse

SetDiagTimeout

设置诊断会话的超时时间。注意:如果在诊断请求进行期间设置超时,时序行为可能不可预测。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

DiagTimeout

int

超时时间(ms)。如果将该值设置为 None,则在打开会话时,超时时间会重置为初始值。

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

SetTargetAddress

Changes the diagnostic target address of the given DoIP session

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

targetAddress

ByteStream(“”)

ByteStream

The diagnostic address of the DoIP entity(ies). If specified, no vehicle identification request is sent and UDS requests are sent directly to this address.

SetTesterPresent

更改测试配置中为周期性发送的 TesterPresent 报文指定的参数。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

TesterPresentCycleTime

int

周期性发送请求的周期长度(ms)。若将周期长度指定为 0,则停用周期性发送

TesterPresentRequest

ByteStream()

ByteStream

循环发送的报文的数据载荷

TransferData

TransferData (0x36):客户端用于传输数据,既可从客户端到服务器(download),也可从服务器到客户端(upload)。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

BlockLength

int

一个块内可传输的最大数据量。包含相应块的服务 ID 和序列计数器。- int

FlashData

ByteStream

要传输的总数据。该作业会根据块长度参数中指定的值自动拆分数据。 ByteStream

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - TransferDataResult

WriteDataByIdentifier

WriteDataByIdentifier (0x2E):允许客户端在服务器中由所提供的数据标识符指定的内部位置写入信息。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

DataIdentifier

int

Identifier

DataRecord

ByteStream

要写入的数据记录 ByteStream

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - WriteDataByIdentifierResult - 或 NegativeResponse

WriteMemoryByAddress

WriteMemoryByAddress (0x3D):WriteMemoryByAddress 服务允许客户端向服务器的一个或多个连续内存位置写入信息。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

DataRecord

ByteStream

要写入的数据 ByteStream

MemoryAddress

int

要写入数据的起始地址

MemorySize

int

要写入的字节数

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - WriteMemoryByAddressResult - 或 NegativeResponse